enable menu
Type
command
Summary
Enables a menu or menu item so that it can be chosen by the user.
Syntax
enable [menuItem <itemNumber> of] menu {<menuName> | <menuNumber>}
enable menuItem <itemNumber> of <button>
Description
Use the enable menu command to enable a menu or menu item so it can be chosen.
If a menuItem is specified, only that menu item is enabled; otherwise, the entire menu is enabled.
When used to enable an entire menu at once, the enable menu command applies only to menus in the current menu bar. To disable a menu associated with a button, use the enable command.
On Mac OS systems, the Apple menu does not have a number and cannot be enabled or disabled. Menu numbering starts with the menu to the right of the Apple menu.
Since a LiveCode menu bar is implemented as a group of buttons (one button per menu, with the menu items as lines in the button's text property), you can indicate a menu by specifying its button. Disabled menu items have an open parenthesis ( at the beginning of the line for that menu item. When used to enable a menu item, the enable menu command removes the open parenthesis from the beginning of the specified line.
Parameters
Name | Type | Description |
---|---|---|
itemNumber | The number of a menu item, from top to bottom of the menu. The first menu item is numbered 1. (Horizontal lines count.) | |
menuName | The name of a menu in the current menu bar. | |
menuNumber | The number of a menu, from left to right. | |
button | Any button. |
Examples
enable menu 2
enable menuItem 3 of menu "Text" -- menu in menu bar
enable menuItem 4 of button "Edit"
Related
function: menus
glossary: property, command, menu item, menu bar
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
Platforms
desktop
server